home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / dlock10.zip / DORLOCK.DOC next >
Text File  |  1991-12-13  |  8KB  |  208 lines
  1.  
  2.                                 DorLock v1.0
  3.  
  4.                         Copyright 1991 Ernie Johnson
  5.                             All Rights Reserved
  6.  
  7.  
  8.     About DorLock
  9.     ----------------------------------------------------------------------
  10.     DorLock is for bulletin board (BBS) sysops looking for a way to keep
  11.     single node doors from causing unpredictable results when used on
  12.     multi node systems - what DorLock does is locks a door when its in
  13.     use on one node, and if a second node tries to access it, a message
  14.     is given stating that the door is in use on another node, or has
  15.     been locked for maintenance purposes.
  16.  
  17.  
  18.     Shareware?
  19.     ----------------------------------------------------------------------
  20.     I'm sure most sysops know what Shareware software is all about, and
  21.     DorLock is a Shareware program.  You are encouraged to register
  22.     DorLock with the author if you plan on using it for your BBS system.
  23.  
  24.     Here's how to register:
  25.  
  26.     Send a letter/postcard stating your BBS name and BBS phone number
  27.     and a brief message stating you use DorLock to:
  28.  
  29.     Ernie Johnson
  30.     EPIC Information Systems
  31.     P.O. Box 607
  32.     Wingham, ON
  33.     N0G 2W0 - Canada
  34.  
  35.     OR,
  36.  
  37.     Phone our support BBS:
  38.  
  39.     EPIC Information Systems:  (519) 357-1943 1200-2400 baud
  40.                                (519) 357-2952 1200-38400 baud USR HST
  41.                                                               Dual Standard
  42.  
  43.     Simply leave a message to the sysop stating you use DorLock, and
  44.     give us your BBS name and phone number so we can upload other things
  45.     to your system.
  46.  
  47.     Of course, any comments or suggestions you may have are also welcome!
  48.  
  49.     Please note that there is no $$ charged for DorLock!  Its what is
  50.     commonly referred to as $0.00 Shareware - all I want to know is if
  51.     people are using my program, and if its worth while spending the
  52.     time writing these freebie doors and documentation!  Of course, I
  53.     wouldn't reject any financial donations, but if most sysops are like
  54.     myself, they need the money for phone bills, registering other doors
  55.     and hardware maintenance.
  56.  
  57.  
  58.     Setting Up DorLock
  59.     ----------------------------------------------------------------------
  60.     DorLock will technically work on any BBS system, although the
  61.     procedure for using doors vary from system to system, I'm sure most
  62.     people will find a way to make it work on any system.
  63.  
  64.     I run PCBoard 14.5a, so I will describe how it is used on PCBoard.
  65.  
  66.  
  67.     First, its easier to do than to say how to do it, so here is a
  68.     sample batch file for a door called "MAILDOR":
  69.  
  70.     Line #      Command
  71.  
  72.       1         @echo off
  73.       2         j:
  74.       3         cd\maildor
  75.       4         J:\pcb\dorlock c:\pcb\pcboard.sys
  76.       5         if errorlevel == 1 goto inuse
  77.       6         maildor c:\pcb\pcboard.sys
  78.       7         del dorlock.dat
  79.       8         :inuse
  80.       9         c:
  81.      10         cd\pcb
  82.      11         board
  83.  
  84.  
  85.     Description:
  86.  
  87.     Line  1: just turn off echo to make things look nice
  88.     Line  2: go to my file server (drive J)
  89.     Line  3: change to the Maildor directory
  90.     Line  4: run the DorLock program - its on my J: drive in the
  91.              \PCB\ directory - DorLock requires the drive, path and
  92.              filename of PCBOARD.SYS, DOOR.SYS, or others (see below)
  93.     Line  5: if the door is already locked, DorLock returns an
  94.              errorlevel of 1, so we find out if the errorlevel is 1
  95.              and if it is, go to line 8 (the :inuse line)
  96.     Line  6: the door mustn't have been locked so run the MAILDOR door
  97.     Line  7: Delete the DORLOCK.DAT file which tells DorLock the door
  98.              is locked - this line is important - or your door will
  99.              be locked until you manually delete DORLOCK.DAT
  100.     Line  8: the "label" that the if errorlevel line needs
  101.     Line  9: go back to the local drive that has the main BBS files
  102.     Line 10: go back to the PCB directory
  103.     Line 11: reload PCBoard
  104.  
  105.  
  106.     For most experience sysops, that should be all that is required to
  107.     get you going.
  108.  
  109.     A few things to be aware of:
  110.  
  111.     1) DorLock creates the DORLOCK.DAT file in the CURRENT directory -
  112.     meaning that you need to be in the door directory that you wish to
  113.     lock, or check the lock status of!  You can run DorLock from
  114.     anywhere (as in example), just make sure the current directory is
  115.     your door directory.
  116.  
  117.     2) Be VERY sure you delete DORLOCK.DAT after the door is run BUT
  118.     before the :INUSE label/line!
  119.  
  120.  
  121.     Maintenance?
  122.     ----------------------------------------------------------------------
  123.     If your system is prone to crashes, you may want to add some lines to
  124.     your events that go through your door directories that are being
  125.     locked by DorLock to delete the DORLOCK.DAT file if it exists.
  126.  
  127.     This will prevent your doors from being locked "for good" (or until you
  128.     manually go through and delete DORLOCK.DAT files).
  129.  
  130.     Of course, if your system is very reliable, and you don't see any
  131.     problems, don't worry about it - most people won't have a need for
  132.     this part anyway.
  133.  
  134.  
  135.     Non-Standard Ports and Interrupts
  136.     ----------------------------------------------------------------------
  137.     If you are running on different port addresses and interrupts, you
  138.     can pass a second command line option:
  139.  
  140.     DORLOCK <path&name of PCBoard.sys> <PORT:AAAA:B>
  141.     where AAAA is the base address, and B is the interrupt (IRQ).
  142.  
  143.     example:
  144.  
  145.     DORLOCK C:\PCB\PCBOARD.SYS PORT:03F8:4
  146.  
  147.  
  148.     Other BBS types:
  149.     ----------------------------------------------------------------------
  150.     If you are trying to use DorLock with a BBS other than PCBoard,
  151.     you will need to tell DorLock what user file you are using.  You are
  152.     also on your own when setting up the door as I only have experience
  153.     with PCBoard version 14.5 and 14.5a.
  154.  
  155.     Here are some samples (untested) as to starting DorLock:
  156.  
  157.     DORLOCK C:\PCB\PCBOARD.SYS   ;PCBoard & compatible PCBOARD.SYS files
  158.                                  ;this one has been tested on my BBS
  159.  
  160.     DORLOCK C:\PCB\DOOR.SYS      ;Systems that generate a DOOR.SYS
  161.  
  162.     DORLOCK C:\PCB\DORINFOx.DEF  ;Systems that generate a DORINFOx.DEF
  163.  
  164.  
  165.     Warranty & Guarantee's:
  166.     ----------------------------------------------------------------------
  167.     DorLock is in no way warranted to be free of defects, bugs, etc.  It
  168.     has, however, gone through extensive testing on my BBS, and I have
  169.     not seen any adverse effects.  I am not responsible for any adverse
  170.     effects it has on your system (just in case).  You should take any
  171.     steps to avoid virus infection and scan the file for viruses before
  172.     using it on your system.
  173.  
  174.     DorLock is copyrighted software.  Please do not make any modifications
  175.     to it!  I am letting you use this software for almost nothing, and
  176.     would expect some common courtesy in return.  If you have suggestions
  177.     for modifications/improvements, please forward them to me through
  178.     one of the methods below:
  179.  
  180.     -- Postal Mail --
  181.  
  182.     Ernie Johnson
  183.     EPIC Information Systems
  184.     P.O. Box 607
  185.     Wingham, ON
  186.     N0G 2W0 - Canada
  187.  
  188.     -- Support BBS --
  189.  
  190.     EPIC Information Systems:  (519) 357-1943 1200-2400 baud
  191.                                (519) 357-2952 1200-38400 baud USR HST
  192.                                                               Dual Standard
  193.  
  194.     -- Voice --
  195.  
  196.     (519) 357-1941 Eastern Time - call between 7pm and 10pm to normally
  197.     talk to the author himself (or you'll get an answering machine).
  198.  
  199.  
  200.     Lastly:
  201.     ----------------------------------------------------------------------
  202.     Please register!  Its only the cost of a postcard/stamp, or phone
  203.     call, but it would tell me if I should continue to write these
  204.     little freebee doors for fellow PCBoard SysOps and spend time writing
  205.     documentation like this.  Your registration does mean a lot ot me,
  206.     and my continuation of quality software at affordable prices!
  207.  
  208.